Contexto global

RunApp

Sintaxis:

RunApp(<CadenaDeComando>, <DirectorioActual>, <EsperarFinalizacion>, <CodigoDeRetorno>)

Parámetros:

Tipo: Cadena.
Línea de comandos para iniciar la aplicación o el nombre de archivo asociado con una aplicación determinada.

Tipo: Cadena.
Establece el directorio actual de la aplicación que se está iniciando.
Se ignora en el modo cliente web.

Tipo: Booleano.
Verdadero – esperar a que la aplicación en ejecución finalice antes de continuar con el trabajo.
Valor predeterminado: Falso.

Tipo: Número, Indefinido.
El parámetro (si se especifica) contiene el código de salida del sistema, el valor pasado por la aplicación al sistema operativo, si la salida se ejecutó correctamente, si se ha obtenido dicho código. De lo contrario, devuelve Indefinido.
Para obtener el código de retorno, el valor del parámetro <EsperarFinalizacion> debe establecerse en Verdadero, la aplicación iniciada debe existir y salir correctamente.

Descripción:

Inicia una aplicación externa o abre un archivo de aplicación con el nombre asociado.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, servidor, cliente grueso, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Nota:

A diferencia de la función System, la aplicación se inicia inmediatamente, sin utilizar el intérprete de comandos.
El comportamiento del método depende del sistema operativo y del modo de ejecución. Los mecanismos del sistema operativo que se utilizan en la implementación del método suponen diferentes variantes de uso. Por ejemplo, el método puede abrir enlaces HTML utilizando el navegador predeterminado en el modo cliente ligero. Estas características se consideran poco confiables porque no se garantiza su presencia en todos los modos de ejecución.
Si 1C:Enterprise se inicia en modo por lotes, o si se llama al método en el servidor, se genera una excepción.
Para utilizar el método en el cliente web, primero debe adjuntar la extensión para trabajar con archivos.
En plataformas móviles, el método solo puede abrir un archivo por asociación.
En la plataforma móvil para Windows, se ignora el parámetro <EsperarFinalizacion> y el método devuelve el resultado una vez que se inicia una aplicación.

Ejemplo:

Véase también:

Contexto global, método BeginRunningApplication
Contexto global, método RunAppAsync

Disponible desde:

Disponible desde la versión 8.0.

Descripción cambiada en la versión 8.3.18.